Summary

Fixes #1660

Updates the SharePoint connector documentation to reflect the object-store listing connector revamp shipped in spiceai/spiceai#10473 — documenting the four new auth flows, the new sharepoint:// URL scheme, and the new write-side parameters.

Changes

• website/docs/components/data-connectors/sharepoint.md
  • Auth flows: Added authorization code, refresh token, device code, and SAML 2.0 bearer (RFC 7522) flows — six total — alongside the existing client_secret and bearer_token flows. Documented sharepoint_redirect_uri (required with auth_code) and sharepoint_scope (defaults to https://graph.microsoft.com/.default).
  • Write support: Documented sharepoint_conflict_behavior (replace (default) / fail / rename) and sharepoint_max_put_bytes (default 1073741824, i.e. 1 GiB), with a limitation note that only replace is compatible with INSERT INTO / COPY TO.
  • sharepoint:// URL scheme: New section documenting the five drive forms (me / drives / sites / users / groups), routing through DataFusion's ListingTable, and pointing readers to the standard listing-table parameters.
  • Required Microsoft Graph permissions: Split into read-only baseline (Sites.Read.All, Files.Read.All, User.Read, GroupMember.Read.All) and the additional Files.ReadWrite / Sites.ReadWrite.All needed for write workflows.
  • Parameter accuracy: Reclassified sharepoint_client_id and sharepoint_tenant_id from "Required" to "Conditional" — they're not required for the bearer_token flow. Updated the auth-exclusivity note to list all six flows.
  • Examples: Added end-to-end examples for SELECT from a SharePoint site library, INSERT INTO, COPY TO Parquet, CREATE EXTERNAL TABLE, and binary blob round-trip via COPY TO (FORMAT binary).

Reference

Verified against spiceai/spiceai at origin/trunk:

• crates/data-connectors/connector-sharepoint/src/lib.rs — PARAMETERS registers all eight new auth/write parameters; build_auth_from_params enforces "exactly one auth flow"; parse_conflict_behavior and parse_max_put_bytes provide the write defaults.
• crates/data_components/src/sharepoint/auth/mod.rs — DEFAULT_SCOPE = "https://graph.microsoft.com/.default"; the SharepointAuth enum dispatches the six flows.
• crates/data_components/src/sharepoint/url.rs — SharepointUrl::from_url parses the five drive kinds.
• crates/data_components/src/sharepoint/object_store.rs — DEFAULT_MAX_PUT_BYTES = 1024 * 1024 * 1024 (1 GiB); only Replace is honored by put / put_multipart.
• crates/data-connectors/connector-sharepoint/README.md — confirms the Microsoft Graph scopes for read-only vs write workflows.

Test plan

• cd website && npm run build passes locally
• No broken-link-checker failures
• Addition is in the unversioned website/docs/ only (per skill rule for new content)
• Existing examples preserved; no behavior changes implied beyond what shipped on trunk